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Markdown - 简单 的 世界 


Markdown 简介 


Markdown 是 一 种 可 以 使 用 普通 文本 编辑 器 编写 的 标记 语言 ， 通 过 简单 的 标记 语法 ， 它 可 以 使 
普通 文本 内 容 具 有 一 定 的 格式 。 


Markdown 具 有 一 系列 衍生 版 本 ， 用 于 扩展 Markdown 的 功能 (如 表格 、 脚 注 、 内 艇 HTML 等 
=) ， 这 些 功能 原初 的 Markdown 尚 不 具备 ， 它 们 能 让 Markdown 转 换 成 更 多 的 格式 ， 例 如 
LaTeX, Docbook, Markdown 增 强 版 中 上 比较 有 名 的 有 Markdown Extra, MultiMarkdown, 
Maruku 等 。 这 些 衍生 版 本 要 么 基于 工具 ， 如 Pandoc ; 要 么 基于 网 站 ， 如 GitHub 和 
Wikipedia， 在 语法 上 基本 兼容 ， 但 在 一 些 语 法 和 演 染 效果 上 有 改动 。 


Markdown 编辑 器 推荐 


在 线 版 


1. dillinger 


漂亮 强大 ， 支 持 md, html, pdf 文件 导出 。 支 持 dropbox, onedrive, google drive, github. 来 自 
国外 ， 可 能 不 够 稳定 。 





Dillinger 


2. StackEdit 


输出 美观 大 方 ， 可 本 地 保存 ， 还 有 拼写 检查 ， 但 是 对 中 文 支持 不 好 ， 可 以 从 截图 中 看 到 ， 中 
文 全 部 被 标记 为 拼写 错误 ， 而 且 源 代码 中 汉字 的 字 间 距 太 大 。 
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J Spatial algorithms x Y & Cmd Markdown - x Y 简 书 x) © StackEdit - Title 


€ CŒ fi Bhitps://stackedit.io 
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n ”段落 和 换行 
和 LATEX 一 样 ， 用 一 个 以 上 的 空 行 代表 分 段 ， 而 没有 空 行 的 换行 被 忽略 ， 所 以 允许 段 内 强制 换行 
m 5H 





Narkdown 支 援 两 种 标题 的 语法 ，Setext 和 atx 形 式 


Setext 形 式 是 用 底线 的 形式 ， 利 用 = ( 最 高 阶 标题 ) 和 - ( 第 二 阶 标题 ) ， 例 如 : 


This is an HL 





is an HO 








Atx 开 





则 是 在 行 首 插入 1 至 6 个 #， 对 应 


例如 


到 标题 1 到 a 阶 ， 
# This is an HL 
H This is an H2 


HEESHHK This is an HE 


SIN 








Markdown 使 用 email 形 
那 会 看 起 来 像 是 






区 块 引言 
然后 在 





"T 


manam 
mm 


你 就 知道 怎 订 在 Narkdown 文 件 中 建立 





> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, 


> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus 


> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. 


或 者 只 在 段落 第 一 行 加 上 > 












s a blockquote with two m ipsum d 





m hendre: 





adipiscing elit tomi pos 





estibulum enim wisi. viverra nec. frinailla in. 





3. MaHua 


小 众 软件 推荐 ， 界 面 有 些 简 陋 。 


MaHua 是 什么 ? 


MaHua {i 9^ 
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one 


有 问题 反 局 
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4. 


书 
一 个 很 不 错 的 博客 平台 ， 每 几 秒 钟 便 会 自动 存 入 
接 ， 一 直 在 不 断 优 化 。 作 为 一 个 博客 平台 


mm 


A, mm 


StackEdit - Title - Google Chrome 


= 应 用 OR O Sci.Soft.&Data O fE Cases CiInSAR O local O 作 图 与 写作 O eClass O forum&groups O 科技 O AX O 常用 





Title 





(I) 区 块 内 容 Block 


段落 和 换行 
和 LATEX 一 样 ， 用 一 个 以 上 的 空 行 代表 分 段 ， 而 没有 空 行 的 换行 被 忽略 ， 所 以 允许 段 内 强制 换行 
Markdown 支 援 两 种 标题 的 语法 ，Setext 和 atx 形 式 。 


Setext 形 式 是 用 底线 的 形式 ， 利 用 = ( 最 高 阶 标题 和 - 第 二 阶 标题 ) ， 例 如 : 


This is an HL 





Atx 形 式 则 是 在 行 首 插入 1 至 6 个 #， 对 应 到 标题 1 到 6 阶 ， 例 如 : 


# This is an Hl 
f$ This is an H2 


PHAR This is an HE 


引言 


Markdown 使 用 emalil 形 式 的 区 块 引言 ， 如 果 你 很 熟悉 如 何在 email 信 件 中 引言 
来 像 是 你 强迫 断 行 ， 然 后 在 每 行 的 最 前 面 加 上 >: 


， 你 就 知道 怎么 在 Markdown 文 件 中 建立 一 个 区 块 引言 ， 那 会 看 起 


> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, 
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. 
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. 


或 者 只 在 段落 第 一 行 加 上 >: 


> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, 
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. 
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. 








一 个 各 份 。 可 以 直接 从 本 地 拖 和 照片 生成 链 


注册 账号 后 方 能 进行 写作 。 
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5. 马克 飞 象 


因为 印象 笔记 不 支持 Markdown， 而 这 款 可 以 直接 把 文本 存 到 印象 笔记 的 编辑 器 对 于 重度 印象 
笔记 用 户 是 个 不 错 的 选择 。 付 费 软件 ， 可 以 免费 试用 。 
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windows 


1. MarkdownPad 


A PTR éd Re ee FR ee OR ee BS ER Markdown 格式 。MarkdownPad 左 右 
栏 的 分 割 方式 合用 户 可 以 实时 看 到 HTML 格式 的 Markdown 文档 。 


Markdown 简单 的 世界 


Fée (da eet View Tool Help 


Deu xoo x ODs oma AiE = 4+ OFRe, 


Web eane to Madlown? pd Lent M | githelbondi X | radeemd x 
a" welcome to MarkdowePad 2 oe 


**MarkdownPad** is a full-featured Markdown editor 
foe Windows. 


s" Guilt exclusively for Markdow* ene 


Enjoy first-class Markdown support with easy access 
to Markdown syntan and convenient keyboard 
shortcuts. 


Give thea à try: 


**Bold** ("ctrl") aed *Itolde* (ctelst ) 
Quotes (CtrleQ ) 

Code blocks (Ctrl ) 

Headings 1, 2, 3 (Orle1 , “Ctrled, rs) 
Lists (“Ctrl aed Cteleshiéten ) 


9*9 See your changes instantly with Live?reviewu ene 
|| Den" guess Lf your [hyperllok systax](http:// 
|| mactdownpad.com) is correct; LivePreview will show 
you exactly what your document locks like every tise 
you press a key, 


ere Make it your own ee 


Fonts, color schemes, layouts and stylesheets are all 


268% Customizable $0 you can turn MarkéownPad into 
your perfect editor. 
|| Weeds 122 


2. MarkPad 


MarkPad 是 款 开源 的 Markdown 编辑 器 ， 与 Window 8 风格 和 谐 友 好 的 界面 ， 可 以 直接 在 你 
的 博客 或 者 GitHub 中 打开 、 保 存 文档 ， 直 接 将 图 片 粘贴 到 Markdown 文档 中 。 


Welcome to MarkdownPad 2 


MartdowePad 5 à fut-teatured Markdown editor for Windows 


Built exclusively for Markdown 


Enoy fest cuv Markudown support ath easy access 12 Mataun 
的 rar and corenient biyboerd shortcut 


Give them a try 


Bold (ctrt«8) ana Baie (Creer) 
Quotes (Ctr1«Q) 

Code Docks (Ctrl) 

Headngs 1 2 3 (Cerie1. Csrio Cte) 
Lists (Ctrl and Ceelesetetea) 


See your changes instantly with LivePreview 


Dom guess f your ypernink syntau is correct LivePreview se stow 
you €xaciy what your document OONS We every tme you press a key 


Make it your own 


Fonts color schemes. üryouts anc stylesheets are ali 100% 
Custormratue $o yOu Can fu" Markóownfad mts your perfect eae» 
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3. Smark 


开源 软件 。 
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Ar a very baty weak we aeq à product Not only that buf weve gor t 
Nedas giete w me td ardens and london irri lode 


do ww d Vo to prevent te pow Maud. 
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4. Miu 


一 款 模仿 mou 的 windows 平 台 markdown 编 辑 器 ， 小 众 推荐 ， 必 属 精 品 ， 官 网 无 法 打开 ， 好 在 
小 众 提供 了 百度 云 下 载 。 界 面 美 观 ， 功 能 不 够 成 熟 


e E eee 
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OSX 


1. Mou 


Mou 是 Mac 下 杰出 的 Markdown 编辑 器 ， 提 供 语法 高 亮 、 在 线 预 览 、 同 步 滚动 、 全 屏 模式 ， 
HAERE Aak, DAELE, Xt CSS, HTML 和 PDF 导出 等 。 


eono Lu help md Oo wards a” 


# Mou Mou 


Mow icon] [httg: //houapp. con/Mou, 128. png 


## Overview 
ee, the aissing Markone editor for «eb Ce 


M Syntax 











ener Strong and Esphasize 
estremo or _strocg_ ( Cad eB) Overview 
sonphasines or emphasive ( Cad ot} Me DA 
Sometimes I want to be bold Syntax 
Like, seriowsly, a d .. 
Strong and Emphasize 
sss Blockquotes .- 
sireng c strong ; 
Right angle brackets & are weed for Bleck quotes. 
weet Links and Email 
Sorrmeteres | wart a lot of Tex be boki. Lie, seriously, è LOT of 
An email <examplegexanple.com Link. teat 
Sigle inline Lisà «tttpi //chee 
Link (Seeller! [https // locust 
wit title [Resize 
extension”). 
A [reference stytellid) Link. Input id, thee anywhere in 
the doc, define the Link wit® corresponding ið 
id}: Sttp://mouapp.com "Markdown editor on Mac OS X 
2. MacDown 
N 
开源 且 免 费 
Ways no 
ann we 


MacDown 
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3. Ulysses 


支持 OS X , iPad， 售 价 283 元 。 堪 称 markdown 编 辑 器 中 的 佼佼 者 。 


Markdown 简单 的 世界 


Cloud 


Ulysses HERSH 

ARA Markdown 185518 908 . 
Ulysses COUSHR LA A CHE ie, EN 
SEPARA NES. ART Uysses 开 -… 


Stier SHAM OSKRER AAR © # Markdown 编辑 器 中 的 佼佼 者 ULysses 上 手 初 体验 


IJEXCRAEGUR, deIR le AA RUDI ROT HH 
性 的 (Review) 长 文 ， 其 中 [Ars Technical 的 … 


不 要 反 游 戏 的 JalT 会 在 iPhone LEMNE 随 着 近 两 年 Markdown 语法 的 不 断 流行 ， 与 之 关 的 各 种 编辑 器 也 陆续 浮 出 水 面 ， 其 中 以 
Pros yen. M-F Mac 平台 上 的 数量 最 为 可 观 ， 但 由 此 带 来 的 还 有 让 用 户 纠结 不 已 的 竞争 关系 。 说 到 竞争 关 


给 ， 人 人 加 把 司 光 主要 集中 于 它 揭 用 户 界面 … i 
IE 系 ， 自 然 要 谈 到 Markdown Editor 的 代表 作 ， 我 认为 可 以 胜任 此 「 头 衔 」 的 有 : 


Boom SM fts jose. RERO 
MO AMDOE EM, RM. CONARI Ulysses, Byword, Mou 和 iA Writer Pro. 
mn (ies 和 其 他 技术 ， 实 现 对 Mac. 


MY. BE, REMAR, Ulysses 绝对 是 一 款 不 可 复制 的 成 功 佳作 ， 这 就 是 为 什么 我 要 将 它 放 
w, AbFE—-HORRSRER. GHA 


Wie. EEE Dock 样式 的 Hecker, SR- Egun, [9nd 6.8 e fpe c FR PR OR SCRSIR ER. RETRA, SRE 


MARLEEN Mac RU TE Ulysses 是 个 富有 创造 性 功能 的 应 用 ， 我 认为 倒 不 如 这 么 比喻 它 强大 的 真正 原因 : mE 
APRS, LERE Mac RRL SUIS AE 
三 方 字体 ， 占 用 了 太 多 磁盘 空间 时 ， 遇 了 时候 打 R. 
开 IPER RAGES SORT. 3D 


OS X HE Secrets 体 答 详解 oh 

[Secrets] -EREE (RRM) 中 的 

X59. SUL ENERTIAREREHL, e menm 
Secrets SEULS ERECTA BUR RUSO EHEC-- 


Ulysses 的 界面 与 iA Writer Pro 近似 ,两 者 都 会 将 分 级 标题 的 「#」 符 号 隐藏 至 左 
边栏 ， 以 让 文章 内 容 居中 显示 ; 其 次 ， 首 次 使 用 的 用 户 一 定 会 注意 到 侧 边 栏 (这 项 特性 包 








4. iA Writer 


支持 OS X,iOS 及 Android， 未 优化 中 文 显 示 ， 售 价 68，pro 版 本 128 元 。 


"Everything goes away except for the writing experience" 





@ The Writing Machine, est. 2010 
In 2010 we released iA Writer, a word processor designed to 
single-mindedly focus on writing. iA Writer became a regular in 
Applo's “Editor Choices" and "Best App of the Year" catogory. 


Our spartan word processor is now the daíly choice of over 
1,000,000 students, journalists, and bestselling authors like 
Stephen Fry, Erik Spiekermana and Augusten Burroughs. with an 
exceptional retention rate of over 80%, it helped pupils, 
bloggers and business people to find the pleasure of working 
with text. iA Writer is one of the fow apps that you install and 
use for good. 


€ "Thank You." — New York Times bestselling author A. Burroughs 
iA Writer's goal is to keep your hands on the keys and your mind 
ín the text, to make sure that, as Stephen Fry said, "everything 
goes away except the writing experience”. It established Reading 


Time, it introduced a simple keyboard extension, it defined a 
new category of fíne tuned writing typography and it gave birth 


5. MWeb 


专业 的 Markdown 编辑 器 。UI 漂 亮 ， 主 题 可 选 。 支 持 markdown 扩 展 语法 ， 支 持 打字 机 滚动 模 
式 ， 支 持 发 布 到 wp、blogger、tumblr 等 多 个 博客 。 
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a MWeb 1.9 An! 新 图 标 、 编 辑 器 大 改进 、 导 出 PDF 改进 、 增 加 图 床 功能 、 中 文 版 等 ! .pdf (第 1 页 ， 共 9 页 ) ~ 


9 发 布 ! 新 图 标 、 编 辑 器 大 改 





新 图 标 
编辑 器 大 改进 
导出 PDF 改进 


增加 图 床 功能 MWeb 1.9 发 布 ! 新 图 标 、 编 辑 器 大 改进 、 导 出 PDF 
增加 图 床 服务 改进 、 增 加 图 床 功能 、 中 文 版 等 ! 


上 传 本 地 图 片 至 图 床 


其 他 改进 : 
新 图 标 


M 


换 了 一 个 新 的 图 标 ， 新 图 标 是 由 Producter http://weibo.com/u/5642390620 设计 
的 ，MWeb 终于 有 了 一 个 高 大 上 的 图 标 了 ! 非常 感谢 ! 


编辑 器 大 改进 


跨 平台 
1. Cmd Markdown 


作业 部 落 出 品 ， 也 是 一 款 不 错 的 工具 和 博客 平台 兼顾 的 产品 。 全 平台 且 提 供 web 版 。 





€: 欢迎 使 用 Cmd Markdown 编辑 阅读 器 


momuTueoTTIETAA5IMOCRTT. wee xc? nino. 
R MARGRA ，**Ced Parkóoe^* HM) See 
r gusset T = om "OHMWTEZOPTTPAISEIBOAT BAe K Pes ott ret | 
(Ol . Cmd Markdown Gt rx ANPALAN 
T ^" 使 用 Cmd Mark 
T < are HIA, 以 使 用 
- " on 条 
ue " 
Mtes mae. Eyb - we) logo pne 
在 看 过 的 这 人 
t ea 前 性 a 
= x P "T mj c 
Ate 
r AT 1511] 
vM 34 nA u 





2. /)\ +5 [E 8 $8.88 


全 平台 覆盖 并 且 有 web 版 。 





Ate no By m ES 


sauce * a5 
EEG EL FESS caa ES EIN 
ES 


3. FarBox 


一 个 支持 Markdown 罕 作 语法 的 博客 平台 ， 让 用 户 通 过 Dropbox (现在 默认 是 自己 的 同步 服务 
器 ) 直接 建立 个 人 网 站 。FarBox 编 辑 器 免费 ， 支 持 多 平台 〈 无 web 版 ，Linux 版 停止 维护 ) ， 
个 人 认为 是 Windows 平 台 最 优雅 的 编辑 器 。 多 说 一 句 ，Farbox 服 务 可 以 免费 斌 用， 在 本 地 编 
辑 器 内 写作 自动 同步 发 布 在 个 人 博客 ， 对 像 笔 者 这 样 希 望 有 个 人 博客 但 却 不 愿 折腾 的 小 白 来 
说 ， 是 个 不 错 的 选择 。 


2015-08-05 15-06-05 08.5 2015-08-05 


NIX 2015-06-30. md #FarBox 
FarBox 
2015-07-16.md zz * iMarkdown? i bis i s s iri x 
2015-07-20 42t**Dropbox** 
+ EESTI 
X 


作 语 法 的 博客 
201507.27.md 
2015-07-29. má aS R : E 
LI A" TAU EwWindows f 6$ M (CR I6 90 20 
dh-010 "um r y 


4. Sublime Text 2 


界面 简约 大 方 ， 定 位 专业 。 价 格 70 美 元 ， 但 是 如 果 你 能 忍受 时 不 时 弹出 的 注册 提醒 ， 完 全 可 
以 免费 使 用 。 唯 一 美中不足 的 是 markdown 并 非 其 原生 功能 ， 需 要 安装 插件 。 


( uint@_t 本 data, size_t len, char è dst) 


sire t src_idx = 0; 
size_t dst_idx = 0; 
(; (src idx + 2) < Very src_idx += 3, dst_idx += 4) 


uint@_t sè = datalsrc_idx); 
t sl = data(src_idx + 1); 
= datalsrc_idx + 2]; 


dst idst_idx + 0) = charset[(s® & Oxfc) >> 2); 
dst idst_idx + 1] = charset[((s@ & 0x03) << 4) | ((s1 & 0x10) >> 4)); 


dst [dst_idx + 2) = charset({((sl 5 @x@f) << 2) | (s2 & Oxc®) >> 6); 
dstidst_idx + 3) = charset[(s2 & Ox3f)]; 
} 


(src idx < Len) 


uinte rt s@ = datal(src_idx]; 
uint@_t $1 = (src_idx + 1 < led) ? datalsrc_idx + 1] : @; 


dst [dst_idx++] = charset((s® 5 Oxfc) >> 2); 
dst idst_idx++] = charset(((s@ 5 @x®3) << 4) | ((s1 & Oxf@) >> 4)); 
(src idx + 1 < lem) 
dst (dst_idx++] = charset[((s1 & @x®f) << 2)); 
} 
5 selection regions 





5. 


github 出 的 编辑 器 ， 功 能 十 分 强大 ， 除 了 编写 代码 之 外 还 可 以 做 为 markdown 编 辑 器 ， 并 且 原 
生 支 持 markdown 预 览 ， 按 ctri+shift+m 弹出 。 


atom.coffee 


extends Model 


Qload0rCreate: (mode) -> 
E .now( ) 

= ( (mode)) ? new this({mode, 

= Date.now() - startTime 





6. 


用 python 开 发 的 ， 所 以 跨 平 台 。ReText 是 一 个 使 用 Markdown 语法 和 reStructuredText 
(reST) 结构 的 文本 编辑 器 ， 编 辑 的 内 容 支 持 导 出 到 PDF, ODT 和 HTML 以 及 纯 文本 ， 支 持 
即时 预览 、 网 页 生成 以 及 HTML 语法 高 完 、 全 屏 模 式 ， 可 导出 文件 到 Google Docs 等 。 


Markdown 简单 的 世界 


of Some Markdown syetax examples 

Welcome te FeTert! 

Here are some examples of Markdown syntax that you can 
edit with ReText, 

To learn wore, follow the “Markdown syntax’ Link in 
“Walp + About fwText disleg. 


eee Basic formatting 
**Bold text** | «Tax? io ifalics* | [Link] 
(http //retest, sourceforge sets) 





部 分 内 容 来 自 月 光 博 客 - 好 用 的 Markdown 编 辑 器 一 览 


Markdown 编辑 器 推荐 


Markdown 基本 语法 


Ju bt 
段 洛 
非常 自然 ， 一 行文 字 就 是 一 个 段落 。 


比如 


会 被 解释 成 


<p> 这 是 一 个 段落 。</p> 


如 果 你 需要 另 起 一 段 ， 请 在 两 个 段落 之 间隔 一 个 空 行 。 


这 是 一 个 段落 。 


这 是 另 一 个 段落 。 


会 解释 成 


<p> 这 是 一 个 段落 <p> 
<p> 这 是 另 一 个 段落 </p> 


不 隔 一 个 空 行 的 换行 行为 ， 在 一 些 编辑 器 中 被 解释 为 换行 ， 即 插入 一 个 <br /> A. MEH 
外 一 些 编辑 器 ， 会 被 解释 为 插入 一 个 空格 。 对 于 后 者 ， 若 要 插入 换行 标签 ， 请 在 当前 一 行 的 
结尾 打 两 个 空格 。 


粗 体 、 和 斜体 
可 以 使 用 星 号 * 或 下 划 线 指定 粗 体 或 者 斜体 。 


* 这 是 斜体 * 

_ 这 也 是 斜体 _ 

** 这 是 粗 体 ** 

*** 这 是 粗 体 + 斜体 *** 


会 被 解释 成 


<em> 这 是 斜体 </em> 

<em> 这 也 是 斜体 </em> 

<strong> 这 是 粗 体 </strong> 
<strong><em> 这 是 粗 体 + 和 斜体 </strong></em> 


删除 线 

一 部 分 编辑 器 支持 删除 线 ， 它 不 是 经 典 markdown 中 的 要 素 。 用 波浪 线 ~ 定义 删除 线 。 
six i~- 

会 被 解释 成 


<strike> 就 像 这 样 </strike> 


— au 
标题 
markdown 总 支持 1~6 六 级 标题 ， 通 过 在 一 行 之 前 加 上 不 同 数 量 的 井 号 来 表示 。 


# 这 是 H1 # 
## 这 是 H2 HH 


HHH 这 是 H3 ### 
HHHHHH 这 是 HO #HHHHH 


行 尾 可 以 加 上 任意 数量 的 井 号 字符 ， 这 些 字符 不 会 算 作 标题 内 容 。 通 常会 加 上 相等 数量 的 字 
符 以 保持 对 称 。 


此 外 ，H1 和 H2 也 可 以 采用 在 文本 下 方 添加 底线 来 实现 ， 比 如 : 


引用 


通过 在 行 首 加 上 大 于 号 > 来 添加 引用 格式 。 


引 


也 


> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, 
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. 
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. 


» Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse 
id sem consectetuer libero luctus adipiscing. 


FAA LARRE : 


> This is the first level of quoting. 
> 
> > This is nested blockquote. 
> 
> 


Back to the first level. 


可 以 谋 套 其 他 格式 : 


## 这 是 一 个 标题 。 


1. ”这 是 第 一 行列 表 项 。 
2. ”这 是 第 二 行列 表 项 。 


给 出 一 些 例子 代码 : 


V VV VVVV V 


return shell exec("echo $input | $markdown script"); 


列表 


无 序列 表 使 用 星 号 、 加 号 或 是 减 号 作为 列表 标记 : 
$ Red 
Green 
$ Blue 
等 同 于 
十 Red 
S Green 
+ Blue 


- Red 
- Green 
- Blue 


有 序列 表 则 使 用 数字 接着 一 个 英文 句点 : 


数字 并 不 会 影响 输出 的 HTML 结果 ， 也 就 是 说 上 面 的 例子 等 同 于 : 


1. Bird 
1. McHale 
1. Parish 


内 联 代 码 


用 反 引 号 ` 来 标记 内 联 代 码 ， 它 们 会 解释 成 «code» 标签 。 如 果 代 码 的 内 容 中 有 上 反 引 号 ， 请 
用 两 个 反 引 号 包 庄 。 代 码 中 的 & 、 < 、 > 符号 都 会 自动 转 义 ， 请 放心 使 用 。 


代码 区 域 


有 两 种 方式 标记 代码 区 域 ， 原 生 风 格 是 行 首 缩 进 死 个 空 


这 是 一 个 代码 区 块 。 


会 被 解释 成 


<p> 这 是 一 个 普通 段落 : </p> 


<pre><code> 这 是 一 个 代码 区 块 。 
</code></pre> 


除了 行 首 的 4 个 空格 会 被 移出 ， 其 它 不 变 。 像 内 联 代码 一 样 ， 上 述 三 种 符号 也 会 被 转 义 。 但 在 
代码 段 中 ， 星 号 之 类 的 markdown 标 记 符 号 则 不 会 解析 。 
还 有 一 种 是 github 的 风格 ， 代 码 段 的 前 后 用 三 个 反 引 号 独占 一 行 来 标记 。 

这 是 一 个 代码 区 块 。 


目前 主流 编辑 器 都 支持 这 种 风格 。 


分 阳线 


你 可 以 在 一 行 中 用 三 个 以 上 的 星 号 、 减 号 、 底 线 来 建立 一 个 分 隔 线 ， 行 内 不 能 有 其 他 东西 。 
你 也 可 以 在 星 号 或 是 减 号 中 间 插 入 空格 。 下 面 每 种 写法 都 可 以 建立 分 隔 线 : 


[an example](http://example.com/) 
[an example](http://example.com/ "Optional Title") 


会 被 解释 为 


«a href='http://example.com/'>an example</a> 
«a href='http://example.com/' title="Optional Title">an example</a> 


除了 上 面 的 行内 式 ， 也 可 以 使 用 参考 式 : 


[an example] [id] 


然后 在 任意 空白 位 置 定义 : 


[id]: http://example.com/ "Optional Title" 


z| 


![Alt text](/path/to/img.jpg) 
![Alt text](/path/to/img.jpg "Optional Title") 


会 被 解释 为 
«img src-'/path/to/img.jpg' alt='Alt text' /> 


«img src-'/path/to/img.jpg' alt='Alt text' title-'Optional Title' /> 


同样 ， 图 像 也 有 关 似 的 参考 式 语 法 。 


目 动 链接 


如 果 链 接 的 地 址 和 名 字 重 复 ， 可 以 用 尖 括 号 语法 将 其 简化 。 


<http://example.com/> 


就 相当 于 
[http://example.com/](http://example.com/) 
切记 ， 大 多 数 编辑 器 都 会 自动 将 符合 url 规 则 的 东西 视 为 链接 ， 并 且 解 释 成 链接 。 很 多 时 候 作 


者 由 于 玻 忽 等 缘故 ， 链 接 和 后 面 的 中 文 之 间 缺 少 空格 ， 导 致 链接 不 正常 。 所 以 我 建议 ， 链 接 
要 么 加 上 类 括号 ， 要 么 两 端 加 上 空格 。 


转 义 


markdown 支 持 在 以 下 字符 前 面 插 入 反 斜 杠 


插入 之 后 ， 将 不 再 解析 这 些 字 符 ， 而 是 原样 输出 。 


表格 


表格 是 github 风 格 独 有 的 语法 ， 但 近年 来 渐渐 被 大 多 数 编辑 器 支持 。 


Phone | $12 


| | 
: | ----: | :---: | 
Computer | $1600 | 5 | 
| | 
Pipe | $1 | | 


会 被 解释 成 


«table» 

«thead» 

«tr» 
«th align="left">Item</th> 
«th align="right">Value</th> 
«th align="center">Qty</th> 

«/tr» 

</thead> 

<tbody><tr> 
<td align="left">Computer</td> 
<td align="right">$1600</td> 
<td align="center">5</td> 

</tr> 

<tr> 
<td align="left">Phone</td> 
<td align="right">$12</td> 
<td align="center">12</td> 

</tr> 

<tr> 
<td align="left">Pipe</td> 
<td align="right">$1</td> 
<td align="center">234</td> 

</tr> 

</tbody></table> 


要 注意 第 二 行 的 冒号 决定 了 居 左 居 右 还 是 居中 ， 如 果 你 不 加 冒号 ， 默 认 是 居 左 的 。 
另外 可 以 把 第 一 行 去 掉 ， 做 成 没有 表 头 的 表格 ， 但 第 二 行 始终 是 要 有 的 。 


内 联 HTML 


markdown 的 语法 简洁 ， 但 有 其 局 限 性 ， 所 以 特意 保留 了 内 联 html 这 种 方式 。 任 何 html 标 签 及 
其 内 容 ， 都 会 原样 输出 到 结果 中 。 也 就 是 说 ， 标 签 中 的 星 号 等 作为 markdown 结 构 的 符号 ， 以 
及 构成 html 标 签 和 实体 的 符号 ， 都 不 会 做 任何 转 义 。 


Markdown 高 级 语法 


只 有 少数 编辑 器 支持 ， 使 用 前 请 先 确认 。 
定义 列表 


Term 1 

Term 2 
Definition A 
Definition B 


会 被 编译 成 


«dl» 

<dd>Term 1«/dd» 
<dd>Term 2</dd> 
<dt>Definition A<dt> 
<dt>Definition A<dt> 
«/dl» 


目录 

通过 [roc] 标记 来 插入 目录 。 

TeX 公 式 

内 联 的 TeX 公 式 使 用 一 个 美元 符号 标记 。 
$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ 


会 被 编译 成 


TeX 公 式 块 用 独占 一 行 的 两 个 美元 符号 来 标记 。 


$$ 
NGamma(z) = Nint O^Ninfty t^{z-1}e^{-t}dt\,. 
$$ 


会 被 编译 成 


DO 
T'(z) -f fe ae. 
0 


如 果 你 的 编辑 器 不 支持 这 个 功能 ， 可 以 手动 解决 。 首 先 引 入 mathjax 脚 本 : 


«script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?con 
图 — — : 
， 在 需要 插入 公式 的 地 方 使 用 «script» H#ADRAT : 











«script type="math/tex">\Gamma(n) = (n-1)!\quad\forall nNinNmathbb N</script> 
<script type="math/tex; mode=display"> 


NGamma(z) = Nint O^Ninfty t{z-1}e4{-t}dt\,. 
«/script» 


TeX 的 语法 参考 请 见 这 里 。 


UMLA 


可 以 像 这 样 来 画 uml 时 序 图 : 


sequence 
Alice->Bob: Hello Bob, how are you? 
Note right of Bob: Bob thinks 
Bob-->Alice: I am good thanks! 







Hello Bob, how are you? 


这 是 uml 流 程 图 : 


Markdown 简单 的 世界 


flow 
st-»start: Start 
e-»end 
op-»operation: My Operation 


cond=>condition: Yes or No? 


st->op->cond 
cond(yes)->e 


cond(no)->op 





My Operation 


时 序 图 的 语法 请 见 这 里 。 流 程 图 的 语法 请 见 这 里 。 


Markdown 高 级 语法 
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Markdown + Gitbook 


使 用 Gitbook 制 作 电 子 书 


Gitbook 是 一 个 命令 行 工具 ， 可 以 把 你 的 Markdown 文 件 汇 集成 电子 书 ， 并 提供 PDF 等 多 种 格 

式 输出 。 你 可 以 把 Gitbook 生 成 的 HTML 发 布 出 来 ， 就 形成 了 一 个 简单 的 静态 网 站 。Gitbook 还 
有 一 个 同名 的 平台 (gibookio) ， 可 以 发 布 和 销售 电子 书 ， 并 提供 了 一 个 Markdown 客 户 端 工 
具 (支持 Mac、Windows 和 Linux) 帮助 写作 。 以 下 是 我 在 使 用 Gitbook 中 的 笔记 。 


首先 Gitbook 和 Git/Github 都 没有 什么 关系 。 它 只 是 一 个 build book 的 工具 而 已 。 但 它 的 Git 前 级 
的 确 引 起 了 许多 人 的 迷惑 ， 起 初 我 认为 至 少 它 也 是 个 和 Github 类 似 的 Git 平 台 吧 ， 但 其 实 没 什 
么 关系 ， 你 只 要 懂 几 条 markdown 语 法 ， 不 必 理 解 任何 与 Git 相 关 的 东西 就 能 用 Gitbook 了 ， 不 


第 0 步 安装 npm (Node Package Manager) 。 从 node.js 的 官网 上 下 载 安装 程序 ， 即 可 完成 
Node.js 和 npm 的 安装 。 


第 1 步 通过 npm 安 装 Gitbook。 
$npm install gitbook -g 
完成 后 花 10 分 钟 阅读 下 Gitbook 的 帮助 文档 。 如 果 你 没 耐 心 看 手册 ， 那 就 继续 往 下 读 吧 :D 
第 2 步 了 解 Gitbook 的 基本 规则 。 
Gitbook 需 要 2 个 基本 文件 : 


e README.md 
e SUMMARY.md 


README.md 是 关于 你 的 书 的 介绍 ， 而 SUMMARYmd 中 则 包含 了 书目 ， 即 章节 结构 ， 它 的 格 
式 大 致 是 : 
* [第 1 章 ] (c1,md) 
[第 1 节 ](c1s1.md) 


* [第 2 节 ](c1s2.md) 
* [第 2 章 ] (c2.md) 


剩 下 的 东西 就 很 好 理解 了 ， 你 只 需要 编写 相应 章节 即 可 。 在 编辑 完 README.md 和 
SUMMARYmd 后 ， 你 可 以 运行 以 下 命令 : 


$ gitbook serve -p 8080 . 


Gitbook 首 先 把 你 的 Markdown 文 件 编译 为 HTML 文 件 ， 并 根据 SUMMARY.md 生 成 书 的 目录 。 
所 有 生存 的 文件 都 保存 在 当前 目录 下 的 一 个 名 为 _book 的 子 目 录 中 。 完 成 这 些 工作 后 ， 
Gitbook 会 作为 一 个 HTTP Server 运 行 ， 并 在 8080 端 口 监听 HTTP 请 求 。 

运行 以 上 命令 后 ， 打 开 浏 览 器 ， 在 地 址 栏 输 入 : http://localhost:8080 即 可 看 到 你 的 书页 


o 


XJ 


其 中 位 于 左 侧 书 目 顶 部 的 introduction 一 节 就 编译 自 README.md， 而 书目 本 身 自 编译 自 
SUMMARY.md。 你 要 在 自己 的 网 站 上 发 布 新 书 ， 只 需 把 _book 目 录 复 制 到 服务 器 相应 目录 即 
可 。 至 此 Gitbook 的 基本 用 法 就 介绍 完毕 。 下 面 简 单 讨论 下 Gitbook 的 其 他 应 用 ， 包 括 Gitbook 
的 插件 、 与 Github 的 融合 、Gitbook 客 户 端 、Gitbook 平 台 ， 以 及 Gitbook 的 问题 。 


Gitbook 的 插件 支持 


Gitbook 可 以 生成 HTML， 因 此 它 支 持 一 些 外 部 的 JavaScript 文 件 伐 入 到 HTML 中 ， 例 如 Google 
统计 、Disqus 评 论 系 统 等 。 以 下 以 页 面 中 府 入 Disqus 评 论 为 例 。 


首先 是 安装 Gitbook 的 Disqus 插 件 。 
$npm install gitbook-plugin-disqus 
然后 建立 一 个 book.json 文 件 ， 其 格式 如 下 : 
{ "plugins": ["disqus"], "pluginsConfig": { "disqus": { "shortName":  "NAME-FROM-D 
4 i 


把 上 面 的 name-rrom-pisqus 修改 为 你 在 Disqus 上 的 项 目 名 即 可 。 





再 次 运行 命令 : 

$ gitbook serve -p 8080 . 
并 刷新 浏览 器 ， 即 可 看 到 附加 了 Disqus 评 论 的 页 面 。 
与 Github 的 融合 


Gitbook 的 博客 上 说 Github 提 供 了 对 Gitbook 的 特殊 支持 ， 但 我 没有 测试 。 只 是 依然 把 源 文件 保 
存在 Github 上 ， 然 后 用 Gitbook 去 编译 。 期 待 Gitbook 做 的 更 好 。 


Gitbook 客 户 端 


Gitbook 客 户 端 支持 Mac、Windows、Linux。 我 在 Mac 和 Windows 简 单 党 斌 了 这 个 客户 端 ， 总 
体 而 言 可 以 用 。 但 也 仅仅 是 可 以 用 而 已 。 你 可 以 在 客户 端 里 编辑 Markdown 文 件 ， 并 提供 一 个 
实时 的 预览 窗口 ; 可 以 关联 到 你 的 Gitbook 账 户 ， 并 把 内 容 同 步 到 gitbook.io， 并 为 你 生成 PDF 
等 。 说 句 题 外 话 ， 如 果 你 要 Markdown 的 客户 端的 话 ， 飞 象 马 克 更 好 用 ， 至 少 Vim 编 辑 模 式 你 
得 支持 啊 。 


Gitbook 的 问题 


Gitbook 网 站 的 访问 速度 很 慢 。 可 以 在 生成 book 目录 后 ， 把 其 中 的 HTML 文 件 和 gitbook 子 目 
录 (包含 字体 和 js 文件 等 ) 复制 到 自己 的 网 站 上 。 


Gitbook 提 供 的 push 功 能 不 能 用 。push.gitbook.io 这 个 地 址 无 法 访问 ， 不 知 是 否 是 临时 性 服务 
故障 。 


Gitbook 生 成 PDF 的 中 文字 体 极其 难看 。 万 分 期 待 改进 。 话 说 Gitbook 生 存 的 HTML 上 的 中 文 非 


ninh Eu 
FB ZRUUo 


在 我 的 手机 上 看 Gitbook 的 页 面 时 ， 会 让 浏览 器 挂 掉 。 


使 用 Gitbook 发 布 电 子 书 


上 次 说 到 用 GitBook 制 作 电 子 书 ， 侧 重 在 使 用 gitbook 这 个 命令 行 工 具 ， 今 天 要 说 的 重点 是 
GitBook 这 个 平台 。 当 你 把 书 放 到 GitBook 上 后 ， 可 以 设置 书 的 价格 〈 每 笔 交 易 GitBook 抽 走 
20% 作 为 佣金 ) ， 也 可 以 设置 为 免费 ， 以 及 接受 捐赠 。 如 果 你 要 收费 或 接受 捐赠 ， 则 需要 一 
个 PayPal 账 户 。 在 开始 前 ， 我 要 友情 提示 一 句 ， 在 国内 访问 GitBook 的 速度 很 慢 ， 通 过 VPN 访 
问 才 好 。 


第 -1 步 用 git 这 个 源 代 码 管理 工具 来 管理 你 的 Markdown 文 件 。 最 好 有 个 GitHub 账 户 ， 这 样 每 
次 push 到 GitHub 时 ，GitBook 都 会 自动 为 你 的 更 新 build 新 的 版 本 (同时 生成 HTML、PDF、 
ePUB、MOBI 这 4 个 版 本 ) 。 


第 0 步 注册 一 个 GitBook 帐 号 。 


第 1 步 在 GitBook 添 加 一 本 书 ， 填 写 书 名 等 基本 信息 即 可 。 完 成 后 ，GitBook 会 为 你 生成 一 个 
git 仓 库 ， 其 格式 为 : 


https://push.gitbook.io/{author}/{book}.git 

author 即 你 的 GitBook 用 户 名 ， book 即 你 的 书 名 ， 如 我 创建 的 书 的 git 仓 库 : 
https://push.gitbook.io/berlinix/guaidanuniversity.git 

这 样 你 可 以 在 编写 完 Markdown 后 ， 通 过 git push 同步 到 GitBook。 


第 2 步 把 你 本 地 的 Markdown 文 件 push 到 GitBook。 我 发 现 git push 时 常 失 败 (服务 器 返回 
5xx 错 误 ) ， 因 此 还 有 一 种 方法 就 是 把 你 的 GitHub 项 目 与 GitBook 关 联 。 每 次 push 到 GitHub 
时 ， 会 通过 GitBook 的 webhook 自 动 同步 到 GitBook 上 。 


{EBook Setting 中 简单 配置 一 下 即 可 ， 如 我 的 配置 为 : berlinix/gdu (GitHub 用 户 名 为 
berlinix，GitHub 仓 库 名 为 gdu) 


在 第 一 次 push 后 ， 就 可 以 看 到 你 在 GitBook 上 的 电子 书 了 ， 其 访问 地 址 为 : 


http://{author}.gitbooks.io/{book}/ 


这 是 你 电子 书 的 主页 ， 从 这 个 页 面 可 以 直接 打开 HTML 版 本 ， 或 下 载 PDF 等 电子 书 版 本 ， 一 般 
用 户 也 可 以 为 你 的 书 添 加 评论 。 如 : 


http://berlinix.gitbooks.io/guaidanuniversity/ 

要 直接 访问 HTML 版 本 ， 可 以 通过 链接 : 
https://www.gitbook.io/read/book/{author}/{book} 

直接 访问 ， 如 : 
https://www.gitbook.io/read/book/berlinix/guaidanuniversity 

至 此 ，GitBook 平 台 的 基本 用 法 就 介绍 完 半 。 下 面 是 我 的 一 些 使 用 经 验 。 

个 性 化 域名 


HTML 版 本 的 URL 很 复杂 ， 可 以 使 用 个 性 化 域名 简化 之 。 在 域名 注册 商 那 里 添加 一 条 CNAME 
记录 即 可 ， 如 : 


CNAME gdu.berlinix.com www.gitbook.io 300 


并 把 gdu.berlinix.com 配置 到 Book Setting 中 去 ， 这 样 可 以 通过 简单 的 gdu.berlinix.com 来 取 
代 https://www.gitbook.io/read/book/berlinix/guaidanuniversity 。 同 理 ， 电 子 书 的 主页 也 可 
设置 个 性 化 域名 ， 就 不 再 次 述 。 


删除 电子 书 
E Æ Book Setting 中 ， 可 以 删除 电子 书 。 在 电子 书 列表 中 没有 删除 接口 。 
GitBook 电 子 书 封面 


可 以 为 电子 书 添加 封面 。 只 需 添 加 2 个 名 为 cover.jpg 和 cover small.jpg 的 两 个 图 片 即 可 。 
官方 建议 cover.jpg 尺 寸 18002360，cover_smalljpg 尺 寸 200262。 花 2 元 即 可 在 淘宝 上 找 个 做 
封面 的 人 为 你 制造 一 个 简单 的 封面 ， 做 得 好 就 要 花 更 多 一 些 了 :) 


GitBookik 5 3: && 


似乎 只 接受 Gravatar com 的 头像 。 把 Gravatar 帐 号 关联 过 去 即 可 。Gravatar 提 供 的 服务 是 把 你 
的 邮箱 和 头像 关联 起 来 ， 当 你 在 其 他 网 站 注册 时 就 不 用 每 次 都 上 传 同 一 个 头像 ， 只 需 简单 与 
Gravatar 帐 号 关联 即 可 。 这 样 蔡 换 头像 也 方便 了 ， 一 次 蔡 换 、 人 处 处 生效 。 

访问 优化 

按 GitBook 的 访问 速度 ， 如 果真 让 人 访问 GitBook 上 的 HTML 页 面 真 是 自 寻 死路 啊 ， 因 此 最 好 是 
把 GitBook 编 译 后 的 HTML 放 在 自己 的 网 站 上 。 同 时 ， 为 自己 网 站 的 HTML 生 成 Disqus 支 持 。 
例如 你 可 以 访问 我 放 到 自己 服务 器 后 的 页 面 (用 手机 访问 效果 也 非常 好 ) 


http://www.berlinix.com/gdu/index.html 


电子 书 Bug 


上 次 说 到 GitBook 生 成 PDF 的 中 文字 体 非常 壬 陋 ， 另 外 还 有 一 个 问题 ， 那 就 是 生成 的 PDF 可 能 
是 残 全 不 全 的 。 我 编译 后 发 现 内容 只 剩 一 半 。 我 已 邮件 过 去 报告 这 个 Bug， 还 在 等 回信 :) 


总 体 而 言 ，GitBook 还 是 很 好 玩 ， 比 起 其 他 写作 平台 而 言 ， 要 自由 、 简 单 ， 并 舒服 得 多 ， 可 以 
用 Vim 编 辑 ， 支 持 Markdown 语 法 ， 用 git 管 理 ， 关 联 GitHub 后 每 次 push 后 还 能 自动 编译 ， 生 成 
多 种 电子 书 格式 。 如 果 你 的 书 极为 畅销 的 话 ， 还 能 获取 到 捐赠 或 购买 ， 没 有 理由 不 尝试 的 
呀 。 


aN 
ya 
来 源 : 


e 使 用 Gitbook 制 作 电 子 书 
e 使 用 GitBook 平 台 发 布 电子 书 


Markdown + R 


来 源 : Markdown E EX i 


科技 写作 与 Markdown+R 
RARE ES ST Ez ? 


如 果 你 是 纯 文 科 生 ， 写 的 都 是 豆 斩 小 酸 文 或 者 诗歌 之 类 的 ， 那 么 ， 看 完 上 面 这 一 部 分 就 可 以 
打住 了 。 如 果 你 还 有 写 科 技 论文 的 需要 ， 则 继续 往 下 看 。 


科技 写作 与 文艺 写作 的 不 同 主要 有 : 


。 公式 与 图 表 : 相信 各 位 写 过 科学 论文 的 ， 都 会 为 数学 公式 与 各 类 图 表 的 输出 头疼 不 已 ; 
。 格式 转换 : pdf 是 通用 的 ， 但 是 有 时 偏偏 需要 LaTeX 原 始 格 式 或 者 Word 原 始 格 式 ; 
。 参考 文献 : 投稿 给 不 同 刊物 ， 往 往 参考 文献 要 根据 对 方 的 格式 来 调整 。 


解决 这 些 难题 ，LaTeX 是 国际 科学 界 ， 尤 其 是 偏 数理 类 的 学 科 的 主流 方案 之 一 。 当 然 ， 因 为 中 
国 盗版 office 的 流行 ， 导 致 国内 科技 论文 Word 更 盛行 ， 则 是 另 一 码 事 。Word 因 为 近 些 年 在 参 
考 文献 协作 软件 、 数 学 公式 方面 的 发 力 ， 也 逐步 成 为 科技 界 认同 的 论文 投递 标准 之 一 。 


提 到 LaTeX 的 人 们 ， 常 常 有 两 种 口气 。 一 种 是 当做 大 神 来 敬仰 的 ， 当 语言 、 软 件 变 为 传奇 ， 路 
人 此 知 它 的 诞生 历史 时 ， 于 是 ， 众 多 如 你 我 这 类 文科 生 ， 只 有 拾 头 仰 纪 的 份 了 。 另 一 类 ， 则 
是 不 屑 的 口气 ，LaTeX 那 么 好 学 ， 你 怎么 都 学 不 会 ! 国际 期 刊 都 是 用 这 个 写 的 ， 你 别 混 

了 。 o o 


于 是 ， 我 等 文科 生 只 好 在 被 鄙视 的 眼光 之 下 ， 快 快走 过 LaTeX。。。 但 是 ，LaTeX 真 的 符合 人 
们 写作 习惯 吗 ? 请 记 住 当时 的 历史 。 那 时 的 计算 机 ， 所 见 即 所 得 ， 并 不 像 今天 这 么 流行 。 那 
时 的 计算 机 ， 处 理 能 力也 不 像 今天 这 么 强大 。 更 别提 什么 脚本 语言 了 。 翻 出 上 一 份 LaTeX 文 档 
所 用 的 APA 模 版 ， 大 家 就 知道 它 有 多 么 坑 侈 了 。。。 


Markdown 简单 的 世界 





日 日 日 5 apaexample.tex 


$u&iutum[|GoGiomoiu 


trf o000-'m]àiu 


pm 


926 
% At ios Proto , October 2005 % 
% Sree. for wing apa. 


% 
JoF0 70707070 7070 7070 76707670 7670 7670 76707670 76707070 7070707070 707070707070 707070 


d» QU Ro f O uo co 4 Ch un d» wn eji 
| 









\gocumentclass[man]{apa} 


Mitle(Example of an APA-style manuscript) 
\author{Athanassios Protopapas) 
Xaffiliationnstitute tor Language \& Speech Processing Ns Athens, Greece) 


\abstract{This is an example of a minimal " manuscript" using the NLaTeXX apa.cls document 
Tu. te psset manuscripts according to the Americal Psychological Association (APA) manual 
edition. 


\acknowledgements{Written at the request of the PracNTeX journal editors. 


Comments may be sent to the author at protopapailsp.ar.) 


\shorttitle{APA style manuscript) 
Vightheader(APA style manuscript} 
NB A.V Protopopos) 


hyd elas 


\section{Experiment 1} 

Manuscripts in APA style often contain descriptions of experiments. The APA manual 
specifications for referring to experiments are to use a lowercase `e" when speaking generally, 
as in the previous phrase, but an uppercase "E" when mentioning a particular experiment (as in 
the following phrase), such as Experiment- 1 . 


Nsubsection(Method) 
The " method" is a subsection of the experimental presentation in which all the details of setting 
up and conducting the experiment are described. There a number of more or less standard 
components to a method, shown below. 
\subsubsection(Participants) 
PsycRological experiments are conducted with participants, usually humans. Note that these 
used to be called "subjects" but apparently APA now finds it inappropriate to refer to people 
with this term. Here we mention how many participants there were, their ages and other 
information about them. 
Meet pporatus) 
Sometimes it s necessary to give the apparatus a special section. 
Nyubsubsection(stimul} 
tthe ic a el a tig or felt. 

ubsu ion{Procedure 
WEEE es to the poor subjects. 
\subsection{Results} 
In this subsection, one shows numbers and statistical analyses. Students are especially unlikely to 
read this section, but seasoned researchers often avoid it in the first reading, especially if the 
article is not of particular interest for their own research. 
\subsection{Discussion} 
If the results of the experiment mean anything, this is the place to talk about it. 


使 用 Lyx， 好 看 多 了 。 Me, CAMS? 你 跳 过 吗 ? 


Markdown+R 如 何 解 决 的 ? 


每 位 试图 解决 LaTeX 的 不 便 ， 又 试图 保留 它 的 优点 的 人 们 ， 都 走 上 了 一 条 不 为 路 。 


Markdown + R 
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直到 有 一 天 ， 极 其 熟悉 LaTeX， 也 熟悉 Markdown 的 yihui 同 学 ， 意 识 到 了 ，LaTeX 它 可 以 作为 
最 终 格 式 生 成 。 但 是 ， 我 们 中 间 的 写作 过 程 ， 完 全 可 以 用 Markdown 这 人 么 简单 明了 的 语法 来 


写 ， 我 们 真正 需要 的 ， 就 是 一 堆 数 学 公式 、 图 表 和 与 参考 文献 而 已 。 前 2 者 ， 恰 恰 是 R 的 强项 。 
后 者 ， 则 留 给 开源 社区 ， 下 一 步 解 决 。 〈 可 参考 线索 1、 线 索 2、 线 索 3) 
于 是 ， 在 他 的 新 作 R 包 knitr 中 ， 果 断 提供 了 Markdown 支 持 。 并 说 服 R 社 区 主流 编辑 器 厂家 ， 


开源 软件 RStudio 提供 Markdown 支 持 ， 从 而 使 得 Rmd 这 种 新 格式 开始 流行 。 我 们 有 幸 看 到 这 
个 重要 格式 的 诞生 ， 国 人 的 贡献 如 此 重要 。 


Rmd 简介 


Rmd 格式 更 详细 的 描述 ， 读 yihui 的 文档 : 自动 化 报告 
在 这 里 ， 让 我 简单 说 明 ， 如 何 最 快 上 手 Rmd 格 式 。 


安 交 并 配置 RStudio 


下 载 RStudio 之 后 ， 打 开 配 置 选项 ， 如 下 图 所 示 : 


File Edit C 


About RStudio i 
»l 

Preferences... 3$, 

Services > 


a 
Hide RStudio 86H 
Hide Others X 38H 
Show All | 


Quit RStudio #0 





然后 ， 进 行 如 下 配置 : 


Options 





p Program defaults (when not in a project) 
[DJ 

D Weave Rnw files using: |knitr :| ? 
General pee 


Typeset LaTeX into PDF using: |pdfLaTex * | ? 


NOTE: The Rnw weave and LaTeX compilation options are also set on a per- 


Code Editing project (and optionally per-file) basis. Click the help icons above for more details. 
| 7 LaTeX editing and compilation 
Appearance (Vf Clean auxiliary output after compile 


(VÍ Enable shell escape commands 


Pane Layout (VÍ Insert numbered sections and subsections 


Q^» [D Invoke compiler via texi2dvi script 

Sweave PDF preview 
ABC Preview PDF after compile using: |RStudio Viewer +| ? 
X 

Spelling 区 Always enable Rnw concordance (required for synctex) 


Version Control 











M" OK | Cancel Apply 


新 建 Rmd 文 档 


新 建 一 个 Rmd 文 档 ， 如 下 图 所 示 : 





RStudio Edit Code View Project Workspace Plots 
: - 一 一 R Script CWN | 
P a Y : 

Open File... 920 ——" 
"]mWeibores Recent Files » 


Reopen with Encoding... 


7S : M R Markdown 
1 Emel (Dave 365 Ime 
2 Save As... R Documentation 
Save with Encoding... 
3 LS save All 
4 , 
| Knit HTML (3H xs 
5 Ed 班级 同学 关系 ， 
6 Print... 
7 EXE Close BW 2 5) HT +R+Markdow 
R Close All TEW 





然后 ， 默 认 会 出 来 一 些 内 容 。 如 果 你 对 Markdown 语 法 有 不 熟悉 的 地 方 ， 点 击 MD 按 钮 。 写 完 
之 后 ， 直 接点 击 : Knit HTML 按钮 即 可 发 布 。MD 按 钮 与 Knit Html 按 钮 的 位 置 如 下 图 所 示 : 


RStudio File Edit Code View Project Workspace Plots Tools 
LOO 
RAE- Si = 





? | rWeibo.test.f | Untitled! x 
es E | 
# RTLS ARa TARA N e HR aR 


©] testl.Rmd* @) sna.old.Rmd ©] sna.Rmd » 















H 背景 


使 用 社会 网 络 分 析 技 术 可 视 化 班级 同学 关系 . 


NOU PWN mp 


一 个 DEMO , 演示 云 中 的 社会 网 络 分 析 +R+Markdown ， 


就 会 预览 成 功 。 你 也 可 以 点 击 保存 ， 生 成 相应 的 图 片 、Markdown 文 档 。 
是 的 ， 你 要 的 一 切 图 片 都 有 了 ! 这 就 是 yihui 所 推崇 的 文学 性 编程 、 可 重复 研究 概念 的 神奇 。 
更 重要 的 是 ， 还 保留 了 对 LaTeX 的 无 颖 兼容 。 比 如， 大 家 可 以 敲 下 这 段 文 字 : 
The Normal Distribution 
The normal distribution is defined as follows: 
latex 
f(x:\mu,\sigma* 2) = \frac{1}{\sigma\sqrt{2\pi}} e*{ -\frac{1}{2 }\left(\frac{x-\mu}{\sigma}\right)*2 | 
To generate random draws from a normal distribution we use the **rnorm** function: 
{r block1} 
output <- rnorm(1000, 100, 15); 
The normal distribution has the typical bell shape: 


{r block2, fig.width=8, fig.height=5} 
ggplot2::qplot(output) 


其 中 ， 这 一 段 ， 


$$latex 
f(x;\mu,\sigma42) = \frac{1}{\sigma\sqrt{2\pi}} e^( -\frac{i}{2}\left(\frac{x-\mu}{\sigma 
$$ 


4 ] 








就 是 直接 生成 LaTeX 格 式 的 数学 公式 ! 


没有 安装 RStudio， 或 者 不 熟悉 R 的 朋友 ， 可 以 在 我 搭建 的 一 个 在 线 演 示 APP 里 面 ， 将 
码 ， 粘 贴 上 去 ， 然 后 看 看 神奇 的 效果 ! 


网 址 是 : R Markdown App 效果 如 下 图 所 示 : 


The Normal Distribution 


The normal distribution is defined as follows: 





à 2 
fou o°) = 
To generate random draws from a normal distribution we use the rnorm function 


output <- rnorm(1000, 100, 15) 
The normal distribution has the typical bell shape: 


ggplot2::qplot(output) 


# stat bin: binwidth defaulted to range/30. Use 'binwidth = x' to adjust 
## this. 


count 





output 


这 么 做 ， 有 什么 好 处 呢 ? 

让 我 细 数 一 下 : 

真正 意义 上 的 可 重复 性 研究 

发 表 论 文 或 者 审核 同事 的 报告 ， 有 个 最 麻烦 的 事情 ， 你 不 知道 他 的 步骤 或 者 计算 是 否 有 误 。 


现在 ， 代 码 谋 在 报告 正文 中 ， 或 者 附录 在 报告 末尾 。 而 你 ， 要 做 的 ， 仅 仅 是 一 键 生成 。。。 
这 就 是 真正 意义 上 的 可 重复 性 研究 ! 


更 强大 的 数学 与 制图 能 

既 兼 容 了 LaTeX 的 既 有 有 能力， 同时， 又 广泛 借助 于 R 自 身 强大 的 作 图 与 统计 学 习 能 力 。 

更 重要 的 是 ， 未 来 ， 并 不 是 非 要 用 RR 语言 作 图 。yihui 同学 在 前 文中 的 描述 已 经 极其 清楚 了 。 
当然 ， 还 有 云 计算 

真正 意义 上 的 云 计 算 ， 尤 其 是 类 似 于 我 们 这 样 ， 中 小 企业 、 小 型 实验 室 实战 使 用 的 小 型 云 计 


算 ， 不 同 于 各 类 忽悠 的 云 计算 。Markdown+R 这 种 方式 是 最 佳 方式 之 一 。 上 述 例 子 中 提 到 的 那 
个 APP， 就 是 搭建 在 云 中 。 同 时 提供 各 类 REST 接 口 ， 可 以 被 Ruby 程 序 调用 。 


Markdown 格 式 与 LaTeX、Word 等 格式 的 互 转 


点 这 里 : Pandoc 


还 有 不 少 有 趣 的 玩法 ， 如 Building a beamer presentation with knitr. 
如 何 学 习 Markdown+R ? 
好 了 ， 回 到 大 家 最 关心 的 部 分 。 分 成 两 部 分 ， 先 是 如 何 学 习 Markdown， 其 次 是 如 何 学 习 R。 


Markdown 格 式 说 明 


e 参考 : Markdown 
e 更 好 的 学 习 办 法 是 直接 读 各 类 范本 文件 
e 更 多 资源 参考 V2ex 节 点 


Markdown 编 辑 器 


e Mac 等 平台 下 推荐 Mou 


。 Windows 平 台 推 荐 MarkdownPad RStudio 可 作为 写作 科技 论文 与 R 语 言 编辑 器 选择 ， 它 
是 跨 平台 此 

e markdown-here 借 助 Chrome 插 件 ， 将 gmai 写 作 窗口 变 为 Markdown 在 线 写 作 窗 口 

e 可 以 直接 在 线 通 过 github 撰 写 与 提交 Markdown 文 件 ，github 有 自动 的 版 本 跟踪 功能 ， 不 
用 担心 写 废 与 找 不 到 以 前 写 的 


Windows 下 的 GitHub 特 别 说 明 


。 如 果 碰 到 git、github 等 与 windows 不 兼容 的 现象 ， 不 建议 折腾 ， 而 是 直接 在 线 提交 即 可 。 
e GitHub 最 近 发 行 了 Windows 版 本 ， 下 载 地 址 在 这 里 
e 我 的 老 文 : 如 何 高 效 利用 github 


如 何 学 习 R 


Rstudio 


e Getting Started with RStudio.pdf 


RZE AT 


e R for SAS and SPSS Users.pdf : 适合 有 SPSS 基 础 的 朋友 
e Analysis of Questionnaire Data with R : 适合 处 理 问 翘 数据 的 文科 生 或 社会 科学 类 
。 更 多 参考 我 的 豆 列 : 技术 派 心理 学 


e 为 什么 文科 生 也 该 用 markdown 寅 作 ? 

e. 为 什么 作家 应 该 用 Markdown 保存 自己 的 文稿 
科学 青 
可 以 看 这 里 : 如 何 学 习 科学 : 开放 科学 工具 箱 


点 击 RAW 即 可 看 到 原始 格式 。 这 是 一 个 长 文档 的 示范 。 另 一 个 示范 是 作者 写 的 一 个 在 线 
DEMO : 


Markdown 简单 的 世界 


云 中 的 社会 网 络 分 析 +Markdown 
以 及 : Markdown* RH X5 fF 


技术 青年 
e knitr 以 及 各 类 Google、 维 基 百 科 。 


。 特别 是 : pandoc-markdown 
e Primarily Pandoc: Writing in Markdown instead of LaTeX 


Markdown + R 
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Markdown + Pandoc 


来 源 : Markdown+Pandoc， 打 通 写 作 界 的 任 督 二 脉 ! 


Markdown+Pandoc， 可 以 把 自己 的 写作 内 容 ， 变 成 世界 上 已 有 的 任何 格式 的 文件 ， 包 括 很 炫 
的 slide，html5。 没 有 人 (或 者 我 没 看 到 ) 总 结 过 这 些 内 容 ， 导 致 我 走 了 很 多 弯路 才 最 终 打通 
任 督 二 脉 ， 特 此 纪念 。 


了 解 Markdwon 以 后 ， 我 的 写作 世界 ， 只 有 它 ; 看 到 Pandoc 格 式 转 换 以 后 ， 对 生成 的 slide 和 
pdf 羔 慕 的 不 行 。 那 时 ， 自 己 期 望 以 后 的 写作 是 这 样 的 : 首先 用 Markdown 把 自己 的 想法 写 下 
来 ; 其 次 ， 通 过 Pandoc， 把 写 好 的 Markdown 文 件 ， 转 换 成 Slide 或 者 PDF。 如 此 而 已 。 


Pandoc， 这 个 不 知道 怎么 发 音 ，google 也 没 找到 。 好 吧 ， 我 就 读 做 panda 吧 ， 谁 让 它 是 国 
Eo 


Pandoc 的 运行 ， 是 在 命令 行 里 面 。 可 是 ， 没 那么 简单 ， 不 是 任何 一 个 cmd 都 可 以 。 你 必须 要 
下 载 Pandoc， 请 参考 这 里 。 根 据 自 己 的 gs， 选择 Windows 或 者 其 他 。 


安装 以 后 ， 记 得 Pandoc 的 目录 是 啥 ， 然 后 再 到 cmd 里 面 去 操作 一 些 失 传 已 久 的 doc 命 令 ， 转 换 
到 pandoc 的 路 径 下 。 


我 个 人 习惯 ， 是 把 要 转换 的 文件 ， 比 如 test.md， 放 到 pandoc 的 路 径 下 ， 这 样 在 使 用 pandoc 转 
换 的 时 候 ， 不 用 输入 太 多 的 路 径 (尤其 是 我 们 很 多 路 径 是 中 文 ， 怕 可 能 有 一 些 问 题 ) 。 当 
然 ， 也 可 以 调用 其 他 路 径 的 文件 ， 只 要 自己 觉得 舒服 。 


pandoc， 就 像 iinux 下 的 iconv， 可 以 把 其 他 格式 的 文件 ， 转 化 成 自己 想 要 的 格式 。 具 体 的 格式 
参考 请 看 这 里 。 


个 人 常用 的 有 两 个 格式 转换 : 
e a: md 文件 转换 成 html5 


pandoc -s --mathml -i -t dzslides test.md -o test.html 


e b: md 文件 转换 成 pdf 


pandoc -t beamer test.md -o test.pdf 


这 里 强调 一 点 ， 如 果 想 转 成 PDF 文件 ， 要 安装 LATEX。 推 荐 安装 MiKTex。 但 是 ， 中 文 转 
PDF， 因 latex 支 持 中 文 差 ， 转 换 有 问题 。 对 于 Latex 熟 悉 的 人 ， 可 以 参考 这 个 ， 看 是 否 能 解决 
中 文 转 slide pdf 的 问题 。 


文件 转换 完成 以 后 ， 如 果 有 一 些 地 方 不 合适 ， 可 以 调整 原始 的 md 文件 ， 再 转换 一 次 。 等 熟练 
以 后 ， 从 写 ， 到 转换 就 非常 迅速 了 。 当然 ，Pandoc 还 有 很 多 的 转换 格式 ， 大 家 可 以 自己 去 研 
关于 Pandoc 的 使 用 ， 我 没有 过 多 的 去 研究 。 只 是 把 自己 常用 的 几 个 功能 熟悉 了 一 下 。 时 间 ， 

真 的 真 的 很 宝贵 ， 不 知 不 觉 就 从 指 缝 中 溜 走 了 。 所 以 ， 我 只 能 在 满足 自己 需求 情况 下 ， 去 使 

用 pandoc。 


期 待 大 家 更 多 的 分 享 ! 


用 markdown 写 博客 : hexo + gitcafe 


Hexo 入 门 指 南 (—) - 简介 & #4 


Hexo 是 一 个 开源 的 静态 博客 生成 器 ， 用 node.js 开 发 ， 作 者 是 台湾 大 学 生 tommy351。 


为 什么 是 博客 


对 于 个 人 网 站 来 说 ， 没 有 上 比 博客 更 合适 的 形式 了 。 在 博客 中 ， 文 章 才 是 最 主要 的 ， 一 切 都 显 
得 主 次 分 明 ， 干净 利落 。 相 比 之 下 ， 论 坛 中 主题 和 回复 鱼 龙 温 杂 ， 阅 读 体验 非常 差 。 同 时 ， 
博客 比 论坛 的 数据 库 小 很 多 ， 便 于 维护 。 


为 什么 是 静态 博客 


很 多 人 选择 在 虚拟 主机 或 vps 上 面 搭建 动态 博客 。 但 是 这 些 主机 商 通常 "免费 的 不 稳定 ， 稳 定 的 
不 免费 "。 前 一 段 时 间 ， 我 观察 了 我 的 个 人 博客 友 链 上 面 的 几 个 站 点 ， 一 部 分 在 十 几 天 之 后 就 
销声匿迹 了 。 独 立 博 客 如 此 麻烦 的 维护 工作 ， 能 不 能 减轻 一 些 呢 ? 正如 阮 一 峰 前 章 所 说 ， 
blogger 分 为 三 个 阶段 。 最 开始 ， 是 门户 博客 。 之 后 ， 是 独立 博客 。 最 后 ， 觉 得 独立 博客 自己 
管理 起 来 费劲 ， 便 找 个 别人 来 管 的 空间 ， 自 己 负责 写 就 好 。 如 果 我 们 能 够 找到 这 样 的 空间 ， 
在 自己 保留 最 大 控制 权 前 提 下 ， 由 别人 托管 ， 会 省 去 不 少 事情 。 


静态 博客 编译 之 后 是 纯 htm| 页 面 ， 优 点 就 是 支持 它 的 环境 十 分 好 找 ， 例 如 github、gitcafe、 七 
牛 云 存储 等 站 点 都 支持 静态 页 面 托 管 ， 自 然 是 我 们 的 首选 了 。 由 于 github page 在 国内 访问 较 
慢 ， 这 篇 文章 用 gitcafe 做 示范 。gitcafe 是 天 朝 本 地 化 的 github， 同 样 提供 展示 页 和 域名 绑 定 功 
能 ， 不 需要 备案 ， 就 是 爽 。 


但 是 静态 博客 并 非 没 有 缺点。 动态 博客 更 新 文章 时 ， 脚 本 是 不 变 的 ， 只 需要 更 新 数据 库 。 静 
态 博客 要 频繁 改动 文件 ， 不 支持 增 量 式 上 传 的 东西 ， 比 如 ftp， 就 难于 管理 。 此 外 ， 还 要 十 分 
熟悉 git 各 种 命令 ， 才 能 部 署 页 面 。 


准 各 工作 


e git 

e node.js 

e markdown 编 辑 器 
e gitcafe 


。 域名 


markdown 编 辑 器 是 非 必 须 的 ， 只 要 你 熟悉 语法 ， 随 便 一 个 编辑 器 来 写 都 不 是 问题 。 


域名 也 是 非 必须 的 ，gitcafe pages 服 务 提供 免费 的 二 级 域名 。 注 册 域 名 的 教程 这 里 就 不 写 
To 


rM " 

BR git 

git 的 客户 端 ， 本 人 推荐 gitrscm。 
linux 下 面 ， 在 bash 中 键入 : 


(Ubuntu, Debian) 


$ sudo apt-get install git 


(Fedora, Red Hat, CentOS) 


$ sudo yum install git 


windows 或 mac 下 ， 直 接 到 git-scm 官 网 下 载 安装 。 


安装 node.js 
linux F : 


$ sudo apt-get install nodejs 
$ sudo apt-get install npm 


yum 同 理 。 


windows 或 者 mac 下 ， 直 接 到 node.js 官 网 下 载 安装 。 windows 还 要 设置 环境 变量 ， 把 node.js 
安装 路 径 写 进 path 里 面 ， 用 半角 分 号 分 隔 。 


markdown 编辑 器 


windows 下 推荐 markdown pad。 


mac 下 推荐 mou。 


gitcafe 


首先 注册 一 个 账号 ， 之 后 点 击 查看 如 何 使 用 pages 服 务 。 


Markdown 简单 的 世界 


相关 网 页 


e Hexo 主 页 
e Hexo github 地 址 
e git book 


Hexo 入 门 指南 (一 ) 


- 简介 & ES 
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Hexo ANHA (—) - 安装 、 初 始 化 和 配置 


BRA AIA 
linux 下 打开 bash，win 下 面 打 开 cmd， 输 入 : 


npm install hexo -g 
hexo init blog 

cd blog 

npm install 

hexo server 


O OGO G 


访问 http://localhost:4000， 会 看 到 生成 好 的 博客 。 


同时 ， 在 blog 文 件 夹 中 ， 文 件 如 下 : 


2014/11/01 19:45 <DIR> 
2014/11/01 19:45 <DIR> 


2014/11/01 11:16 68 .gitignore 
2014/11/01 17:33 13,767 db.json 
2014/11/01 11:16 «DIR» node modules 
2014/11/01 11:17 186 package.json 
2014/11/01 11:23 «DIR» public 
2014/11/01 11:16 «DIR» scaffolds 
2014/11/01 17:31 <DIR> source 
2014/11/01 11:16 <DIR> themes 
2014/11/01 11:38 1,844  config.yml 


Acie 
站 点 的 配置 文件 是 _config.yml， 如 果 你 不 小 心 改 花 了 ， 这 里 提供 了 一 份 默认 的 : 


# Hexo Configuration 
## Docs: http://hexo.io/docs/configuration.html 
## Source: https://github.com/hexojs/hexo/ 


# Site 

title: Hexo 
subtitle: 
description: 
author: John Doe 
email: 

language: 


# URL 

## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root 
url: http://yoursite.com 

root: / 

permalink: :year/:month/:day/:title/ 

tag dir: tags 

archive dir: archives 

category dir: categories 

code dir: downloads/code 

permalink defaults: 


# Directory 
Source dir: source 
public dir: public 


# Writing 
new post name: :title.md £ File name of new posts 
default layout: post 
titlecase: false # Transform title into titlecase 
external link: true # Open external links in new tab 
filename case: 0 
render drafts: false 
post asset folder: false 
relative link: false 
highlight: 
enable: true 
line number: true 
tab replace: 


# Category & Tag 

default category: uncategorized 
category map: 

tag map: 


# Archives 

## 2: Enable pagination 
## 1: Disable pagination 
## 0: Fully Disable 
archive: 2 

category: 2 

tag: 2 


# Server 

## Hexo uses Connect as a server 

## You can customize the logger format as defined in 
## http://www.senchalabs.org/connect/logger.html 
port: 4000 

server_ip: localhost 

logger: false 

logger_format: dev 


# Date / Time format 

## Hexo uses Moment.js to parse and display date 
## You can customize the date format as defined in 
## http://momentjs.com/docs/#/displaying/format/ 
date_format: MMM D YYYY 

time format: H:mm:ss 


# Pagination 

## Set per page to 0 to disable pagination 
per page: 10 

pagination dir: page 


# Disqus 
disqus shortname: 


# Extensions 

## Plugins: https://github.com/hexojs/hexo/wiki/Plugins 
## Themes: https://github.com/hexojs/hexo/wiki/Themes 
theme: landscape 

exclude_generator: 


# Deployment 
## Docs: http://hexo.io/docs/deployment.html 
deploy: 

type: 


«| Em 











官方 的 页 面 上 也 提供 了 每 一 项 详细 的 解释 。 


我 们 需要 修改 的 只 有 Site 部 分 ， 以 及 URL 部 分 的 url。Site 部 分 每 一 项 依次 是 标题 、 副 标题 、 描 

述 、 作 者 、 邮 箱 和 语言 (天 朝 大 陆 填 zh-CN) 。url 改 成 网 站 的 网 址 ， 如 果 你 的 网 站 放 在 某 个 

子 目 录 下 ， 比 如 http:/yoursite.com/child，root 改 成 /child。 

Server 部 分 ， 如 果 之 前 你 的 服务 器 没有 运行 起 来 ， 则 可 能 是 端口 被 占 了 。 把 port 改 成 别 的 数 
或 者 强行 关 掉 占 着 端口 的 进程 。 


字 ， 
其 它 设置 项 先 不 用 管 ， 将 会 在 接 下 来 的 文章 中 解释 。 


如 果 页 面 中 出 现 中 文 ， 应 以 UTF-8 无 BOM 编 码 格式 ， 所 以 不 要 用 win 自 带 的 记事 本 ， 而 是 用 
notepad++ 这 种 支持 编码 转换 的 编辑 器 。 


由 于 google 在 天 朝 大 陆 被 墙 ， 进 入 themes\landscape\layout_partial， 打 开 head.ejs， 删 掉 第 
31 行 fonts.googleapis.com 的 链接 。 


下 载 下 来 jquery-2.0.3.min.js， 放 到 themes\landscape\source\js 文 件 夹 中 。 之 后 进入 
themes\landscape\layout_partial， 打 开 after-footer.ejs， 将 第 17 行 的 路 径 蔡 换 为 /js/jquery- 
2.0.3.min.js。 


至 此 大 功 告 成 。 


Hexo 人 门 指南 (=) - 文章 & 草稿 


m 
文章 
命令 行 中 输入 : 


$ hexo new "new article" 


之 后 在 source/_posts 目 录 下 面 ， 多 了 一 个 new-article.md 的 文件 。 


打开 之 后 我 们 会 看 到 : 


title: new article 
date: 2014-11-01 20:10:33 
tags: 
文件 的 开头 是 属性 ， 采 用 统一 的 yaml 格 式 ， 用 三 条 短 横 线 分 隔 。 下 面 是 文章 正文 。 


文章 的 正文 支持 markdown 格 式 ， 建 议 你 先 学 习 一 下 它 的 语法 。markdown 不 像 html 似 的 一 大 
堆 标 签 ， 很 简单 ， 只 有 几 个 符号 。 


新 建 、 删 除 或 修改 文章 后 ， 不 需要 重启 hexo server， 刷 新 一 下 即 可 预览 。 


属性 


文章 可 以 拥有 如 下 属性 : 
Setting Description Default 
layout Layout post 或 page 
title 文章 的 标题 
date 创建 日 期 文件 的 创建 日 期 
updated 修改 日 期 文件 的 修改 日 期 
comments 是 否 开启 评论 true 
tags 标签 
categories S 
permalink url 中 的 名 字 文件 名 


动态 博客 中 通过 发 布 文章 页 面 设 置 的 各 种 属性 ， 在 hexo 里 要 这 样 设置 。 


分 类 和 标签 
例如 : 


categories: 
= 日 记 
tags: 

- Hexo 

- node.js 


摘要 


同 wordpress 一 样 ， 之 上 的 内 容 为 摘要 。 


layout 


如 果 你 修改 了 layout， 在 scaffolds 文 件 夹 里 一 定 要 有 名 字 对 应 的 模版 文件 ， 否 则 会 采用 默认 模 
版 。 


文件 名 


在 配置 文件 中 的 new_post_name 项 可 以 设置 文件 名 ， 黑 认为 :title， 也 就 是 你 在 命令 行 输入 的 
名 字 。 


文件 名 可 以 为 下 面 几 个 变量 和 字符 串 常量 的 任意 组 合 : 


Variable Description 
:title Escaped title (lower case and replace spaces with dash) 
‘year Created year (4-digit) 
“month Created month (2-digit) 
:month Created month (Without leading zeros) 
:day Created day (2-digit) 
i day Created day (Without leading zeros) 
草稿 


草稿 相当 于 很 多 博客 都 有 的 “私密 文章 "功能 。 


$ hexo new draft "new draft" 


会 在 source/_drafts 目 录 下 生成 一 个 hew-draft.md 文 件 。 但 是 这 个 文件 不 被 显示 在 页 面 上 ， 链 
接 也 访问 不 到 。 也 就 是 说 如 果 你 想 把 某 一 篇 文章 移 除 显示 ， 又 不 舍得 删除 ， 可 以 把 它 移动 到 
_drafts 目 录 之 中 。 


如 果 你 希望 强行 预览 草稿 ， 更 改 配 置 文件 : 


render_drafts: true 


或 者 ， 如 下 方式 启动 server : 


$ hexo server --drafts 


下 面 这 条 命令 可 以 把 草稿 变 成 文章 ， 或 者 页 面 : 


$ hexo publish [layout] <filename> 


Hexo 入 门 指 两 (四) - WE. Sm. VE. BE 


$ hexo new page about 


会 在 source/about 中 生成 index.html。 这 个 就 叫做 页 面 ， 不 在 文章 列表 显示 ， 可 以 通过 
http://localhost/about 浏 览 。 


页 面 支 持 文章 的 大 部 分 属性 ， 除 了 分 类 和 标签 。 


导航 


打开 主题 中 的 设置 文件 ， 即 themes\ config.yml (其 中 是 当前 主题 的 名 字 ， 默 认为 
landscape, FAF) ， 找 到 menu:， 在 列表 的 末端 添加 About: 关于 。 刷 新 页 面 ， 导 航 栏 上 就 出 
现 了 关于 链接 。 


边栏 


进入 themesNlayout widget 目录 中 ， 创 建 about.ejs 文 件 ， 模 优 其 他 文件 中 的 模版 ， 输 入 以 下 
内 容 : 


<% if (site.tags.length){ %> 
«div class-"widget-wrap"- 
«h3 class="widget -title">About</h3> 
<div class="widget"> 
邮箱 : XXX@xxx.com<br /> 
微 博 : Qxxxxx 
«/div» 
«/div» 
<% ) %> 


打开 themes\_config.yml， 找 到 #Sidebar， 在 最 后 面 添加 - about。 刷 新 页 面 。 


ERS 


打开 themes\\layout_partial\footer.ejs 修 改 。 


-banner- 


打开 themes\\source\css\images， 把 banner.jpg 换 掉 。 


Hexo 入 门 指南 (五 ) -搬家 & 各 份 


搬入 hexo 


首先 ， 需 要 拿 到 原 博客 数据 的 xml 文 件 。 


wordpress 的 话 ， 后 台 “ 工 具 -> 导出 ?就 可 以 生成 。 点 点 和 lofter 也 支持 类 似 操 作 。 如 果 遇 到 不 支 
持 导出 xml 的 博客 ， 先 用 http:/www.diandian.comy/transfer 转 到 点 点 ， 再 


用 http:/www.diandian.com/backup 导 出 XML 文件 。 


之 后 ， 安 装 hexo-migrator-wordpress 这 个 插件 
npm install hexo-migrator-wordpress --save 

v= $= 

iS1T 


hexo migrate wordpress wordpress.xml 


xml 中 的 数据 就 导入 到 source 中 了 。 最 后 的 工作 是 修复 链接 什么 的 。 


搬出 hexo 


没有 什么 好 的 办 法 。 可 以 写 个 脚本 表 历 public 文 件 夹 ， 之 后 post 到 指定 目录 或 者 制作 成 xml 文 
件 。 


备份 
有 句 话说 得 好 ， 数 据 恢复 的 最 佳 方案 永远 是 “各 份 各 份 再 各 份 ”。 


个 人 建议 ， 分 别 各 份 站 点 配置 和 文章 。 站 点 配置 包括 blog 根 目录 除了 source 和 public 文 件 夹 的 
所 有 内 容 ， 文 章 就 是 source 文 件 夹 的 全 部 内 容 。 站 点 配置 不 经 常 变 的 话 可 以 不 用 经 常 各 份 。 


Hexo 入 门 指南 (六) -sitemap. rss 和 部 署 


sitemap & rss 


切换 到 blog 根 目录 下 ， 输 入 : 


$ npm install hexo-generator-feed 
$ npm install hexo-generator-sitemap 


之 后 重启 博客 ， 访 问 /atom.xml 和 /sitemap.xml， 会 发 现 已 经 生成 了 。 可 以 把 sitemap 提 交 到 搜 
索引 擎 的 站 长 平台 来 增加 收录 。 


部 署 


首先 按照 前 面 教程 (—) 的 gitcafe 部 分 建立 好 代码 仓库 ， 这 里 假设 你 的 用 户 名 是 
your_name。 由 于 ssh 配 置 比较 麻烦 ， 这 里 采用 https 方 式 提交 。 


找到 配置 文件 中 # Deployment 一 节 ， 修 改 : 


type: github 
repository: https://gitcafe.com/your name/your name.git 
branch: gitcafe-pages 


之 后 输入 : 
hexo deploy --generate 

或 者 
$ hexo generate --deploy 

hexo 会 自动 生成 并 部 署 。 

如 果 之 前 已 经 生成 过 了 ， 直 接 输入 : 
$ hexo deploy 


部 署 即 可 。 


当然 ， 这 个 命令 还 有 一 些 bug， 比 如 windows 下 不 能 用 cmd 而 是 用 gitshell。 我 自己 一 般 会 手动 
敲 git 代 码 履 盖 提 交 。 


Markdown 简单 的 世界 


Hexo 入 门 指 南 (六 ) - sitemap、rss 和 部 署 
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Hexo 和 人 入门 指南 (七 ) -评论 & DS 


评论 
hexo 默 认 集 成 了 disqus， 但 是 在 天 朝明 显 多 说 更 受 欢迎 一 点 。 


首先 至 到 多 说 官 网 去 注册 一 个 账号 。 然后 点 击 入 添加 站 点 页 面 ， 填写 所 有 信息 。 注意 ， 多 说 
域名 的 前 级 就 是 站 点 的 短 网 址 ， uni ix EB it 7; short name, 


在 _config.yml 中 添加 多 说 的 配置 


duoshuo shortname: short name 


修改 themes\\layout_partial\article.ejs， 把 第 38 行 到 41 行 的 如 下 代码 : 


<% if (!index && post.comments && config.disqus_shortname){ %> 
«section id="comments"> 
«div id-"disqus thread"» 
<noscript>Please enable JavaScript to view the «a href="//disqus.com/?ref_noscript">c 
</div> 
</section> 
<% } %> 


EE: 
替换 成 : 





<% if (!index && post.comments && config.duoshuo_shortname){ 96» 
«section id="comments"> 
<!-- 多 说 评论 框 start --> 
«div class-"ds-thread" data-thread-key="<%= post.layout %>-<%= post.slug %>" data-title 
<!-- 多 说 评论 框 end --» 
<!-- 多 说 公共 JS 代码 start (一 个 网 页 只 需 插 入 一 次 ) --> 
<script type="text/javascript"> 
var duoshuoQuery = {short_name:'<%= config.duoshuo shortname %>'}; 
(function() { 
var ds = document.createElement('script'); 
ds.type - 'text/javascript';ds.async - true; 
ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static. 
ds.charset - 'UTF-8'; 
(document.getElementsByTagName( 'head')[0] 
|| document.getElementsByTagName( 'body') [0]).appendChild(ds); 
DHO; 
</script> 
<!-- 多 说 公共 JS 代码 end --> 
«/section» 
<% ) %> 


SSS 
之 后 ， 找 到 第 27 到 29 行 





<% if (post.comments && config.disqus shortname)[( 96» 
«a href="<%- post.permalink %>#disqus_thread" class-"article-comment-link"»Comments«/a» 
<% ) %> 


4 nm 
替换 成 : 








<% if (post.comments && config.duoshuo_shortname){ %> 
«a href="<%- url for(post.path) %>#comments" class="article-comment-1Link"> 留 言 </a> 
<% ) %> 


DF 
hexo 默 认 提供 的 那 四 个 在 国内 也 被 墙 了 。 这 里 蔡 换 成 百度 一 键 分 享 。 
找到 themes\landscape\layout_partialarticle.ejs26 行 : 


«a data-url="<%- post.permalink %>" data-id="<%= post. id %>" class="article-share-link"> 
1 LLL 
蔡 换 成 : 





«a data-url="<%- post.permalink %>" data-id="<%= post. id 95?" class="article-share-link b 
<script>window._bd_share_config={"common": {"bdSnsKey": {}, "bdText":"", "bgMini":"1","bdMini 


JE, [pem] 


之 后 打开 themes\landscape\source\js\script.js，35~86 行 全 部 注释 掉 。 





后 记 


仅 以 此 教程 ， 悼 念 Aaron Swartz，RSS 和 Markdown 的 联合 创始 人 。 没 有 他 ， 开 源 博 客 界 就 不 
会 有 今天 。 


